home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / gnu / gawk / cawf2st.zoo / fontfilt.man < prev    next >
Text File  |  1991-06-04  |  8KB  |  196 lines
  1.  
  2.  
  3. FONTFILT(1)                Unix Programmer's Manual                FONTFILT(1)
  4.  
  5.  
  6. BNBABMBE
  7.      fontfilt - font filter for cawf
  8.  
  9. BSBYBNBOBPBSBIBS
  10.      BfBoBnBtBfBiBlBt [ B-Bc IcIoInIfIiIg ] [ B-Bd IdIeIvIiIcIe ] [ B-Bf IfIoInIt ] [ B-Bh ] [ IfIiIlIe(Is) ]
  11.  
  12. BDBEBSBCBRBIBPBTBIBOBN
  13.      IFIoInItIfIiIlIt enhances IcIaIwIf(1) output with device-specific  control  sequences
  14.      that  select fonts and display bold and italic characters.  (The IcIaIwIf B-BfBe
  15.      option must be used to identify bold and italic characters.)
  16.  
  17. BOBPBTBIBOBNBS
  18.      IFIoInItIfIiIlIt options select the configuration file, the device, the font  and
  19.      the input source.
  20.  
  21.      B-Bc IcIoInIfIiIg
  22.           specifies the name of the configuration file.  (See the BDBEBVBIBCBEBS  BABNBD
  23.           BFBOBNBTBS and BCBOBNBFBIBGBUBRBABTBIBOBN BFBIBLBE sections for more information.)
  24.  
  25.      B-Bd IdIeIvIiIcIe
  26.           specifies the printer output device.  The default is the name of the
  27.           last device in the configuration file, usually ``ansi''.
  28.  
  29.      B-Bf IfIoInIt
  30.           specifies the desired printer font  name.   The  default  is  device
  31.           specific.
  32.  
  33.      B-Bh   requests a usage information display (help) that includes a list  of
  34.           the devices and fonts that are supported.
  35.  
  36.      IfIiIlIe(Is)
  37.           specify the paths to IcIaIwIf output files.
  38.  
  39. BDBEBVBIBCBEBS BABNBD BFBOBNBTBS
  40.      The  devices  and  fonts  that  IfIoInItIfIiIlIt  supports  are  defined   in   a
  41.      configuration  file.  The default configuration file is named IfIoInItIfIiIlIt.IcIf
  42.      and is  located  in  Ic:/IsIyIs/IlIiIb/IcIaIwIf  (the  author's  MS-DOS  environment
  43.      default).
  44.  
  45.      The IfIoInItIfIiIlIt.IcIf configuration  file  of  this  distribution  defines  the
  46.      following devices and fonts.  Use the B-Bh option to see the definitions of
  47.      your active configuration file.  (The first font named in  the  following
  48.      listing and in the B-Bh display is the default for the device.)
  49.  
  50.      ansi      ANSI terminal display
  51.                (ANSI.SYS driver required for MS-DOS)
  52.                Italic:   Underscore
  53.                Fonts:    none
  54.  
  55.      epson     dot matrix printer in Epson FX-86e/FX-800 mode
  56.                Bold:     Double-strike
  57.                Fonts:    none
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                   May, 1991                                  1
  65.  
  66.  
  67.  
  68. FONTFILT(1)                Unix Programmer's Manual                FONTFILT(1)
  69.  
  70.  
  71.      ibmppds   IBM Personal Printer Data Stream (PPDS) protocol
  72.                Bold:     Double-strike
  73.                Italic:   Underline
  74.                Fonts:    none
  75.  
  76.      kxp1180   Panasonic KX-P1180 dot matrix printer in PGM mode
  77.                Bold:     Emphasized
  78.                Fonts:    c10        10 Characters Per Inch (CPI) Courier
  79.                          c12        12 CPI Courier
  80.                          bps10      10 CPI Bold PS
  81.                          bps12      12 CPI Bold PS
  82.                          p10        10 CPI Prestige
  83.                          p12        12 CPI Prestige
  84.                          ss10       10 CPI Sans Serif
  85.                          ss12       12 CPI Sans Serif
  86.  
  87.      lj3       HP LaserJet III
  88.                Fonts:    c10        10 point, 12 Characters Per Inch (CPI)
  89.                                     Courier
  90.                          c12ibm     12 point, 10 CPI Courier, IBM-PC
  91.                                     Symbol Set
  92.                          lg12       12 point, 12 CPI Letter Gothic
  93.  
  94.      vgamono   VGA monochrome monitor for MS-DOS
  95.                (ANSI.SYS driver required for MS-DOS)
  96.                Italic:   Reverse-video
  97.                Fonts:    none
  98.  
  99. BEBXBABMBPBLBEBS
  100.      The IcIaIwIf invocation must use  its  B-BfBe  option.   The  following  example
  101.      selects the 12 CPI Prestige font on a Panasonic KX-P1180 printer.
  102.  
  103.           cawf -fe -man cawf.1 | fontfilt -d kxp1180 -f p12
  104.  
  105.      The following example selects the 12 CPI Letter  Gothic  font  on  an  HP
  106.      LaserJet III printer.
  107.  
  108.           cawf -fe -man cawf.1 > lj3.tmp
  109.           fontfilt -dlj3 -flg12 lj3.tmp > lpt1:
  110.  
  111. BCBOBNBFBIBGBUBRBABTBIBOBN BFBIBLBE
  112.      IFIoInItIfIiIlIt searches for its  configuration  file  in  Ic:/IsIyIs/IlIiIb/IcIaIwIf  (the
  113.      author's  MS-DOS environment default).  This default can be overridden by
  114.      the CAWFLIB environment variable, or changed in the source code.
  115.  
  116.      The configuration file has a simple format that conforms to the following
  117.      rules.
  118.  
  119.      1.   Lines that begin with a pound sign (`#') a  space  or  are  zero  in
  120.           length are ignored.
  121.  
  122.      2.   Lines that begin with an alphabetic character name a device.
  123.  
  124.      3.   Device lines may be followed by lines that define the device  escape
  125.           control  sequences  for  bold,  italic and Roman characters, or font
  126.           definitions.  These definition lines must begin with a TAB, followed
  127.  
  128.  
  129.                                   May, 1991                                  2
  130.  
  131.  
  132.  
  133. FONTFILT(1)                Unix Programmer's Manual                FONTFILT(1)
  134.  
  135.  
  136.           by a single character defining the type of definition,  followed  by
  137.           an equal sign (`=').
  138.  
  139.      4.   The bold, italic and Roman definition types are `b',  `i'  and  `r'.
  140.           An  equal  sign  follows  the  single type character, and the device
  141.           escape control sequence follows it.  (See rule 6 for  a  description
  142.           of the encoding of the control sequence.)
  143.  
  144.      5.   The font definition type is `f'.  It's followed by  an  equal  sign,
  145.           the  name  of  the font (it must not include an equal sign); another
  146.           equal sign, terminating the font name; and after  the  second  equal
  147.           sign,  the  device  control  sequence to make the font active.  (See
  148.           rule 6 for a description of the encoding of the control sequence.)
  149.  
  150.           The first font definition for a device is assumed to be the  default
  151.           font for the device.
  152.  
  153.      6.   All  characters  following  the  equal  sign  up  to  the   terminal
  154.           end-of-line  character  are part of an escape control sequence.  The
  155.           sequence may contain any printable ASCII characters.   Non-printable
  156.           characters  can  be  encoded  in  octal  with the `\nnn' form, or in
  157.           hexadecimal with the `\xnn' form.  The special code,  `\E'  or  `\e'
  158.           represents the ESC control character, octal 033 (hexadecimal 1b).
  159.  
  160.      Here's an example showing the definition for the HP LaserJet III.  All of
  161.      its non-printable characters are ESC's; the first is coded with the octal
  162.      form (`\033'); the second, with `\E'; the rest, with the hexadecimal form
  163.      `\x1b'.
  164.  
  165.           # HP LaserJet III
  166.  
  167.           lj3
  168.                     b=\033(s7B
  169.                     i=\E(s1S
  170.                     r=\x1b(s0B\x1b(s0S
  171.                     f=c10=\x1b&l0O\x1b(8U\x1b(s0p12h10v0s0b3T
  172.                     f=c12ibm=\x1b&l0O\x1b(10U\x1b(s0p10.00h12.0v0s0b3T
  173.                     f=lg12=\x1b&l0O\x1b(8U\x1b(s12h12v0s0b6T
  174.  
  175.  
  176. BSBEBE BABLBSBO
  177.      bsfilt(1), cawf(1) and nroff(1).
  178.  
  179. BDBIBABGBNBOBSBTBIBCBS
  180.      Diagnostic messages are delivered to the standard error file.
  181.  
  182. BHBIBSBTBOBRBY
  183.      IFIoInItIfIiIlIt  was  written  by  Vic  Abell,  <abe@mace.cc.purdue.edu>.   Chet
  184.      Creider  <creider@csd.uwo.ca>  had  the  idea  for  it  and provided some
  185.      device-specific prototypes, adapted from the IrIo work of Ted A.  Campbell.
  186.      (Campbell's IrIo is based on ROFF4.)
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                   May, 1991                                  3
  195.  
  196.